home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / bsml_250.zip / BINK_250.DOC next >
Text File  |  1991-09-16  |  30KB  |  840 lines
  1.  
  2.  
  3.                 Addendum to BinkleyTerm Documentation
  4.  
  5.                        Changes and Additions
  6.                    for BinkleyTerm Version 2.50
  7.  
  8.              Copyright (C) 1991 Bit Bucket Software, Co.
  9.  
  10. INTRODUCTION
  11.  
  12. Once again, the documentation for this latest release of BinkleyTerm is
  13. being issued as an addendum to the previous docs.  Information contained
  14. herein should be considered as superseding any previous documentation.
  15.  
  16. We expect to have a comprehensive update for the BinkleyTerm docs by Q4
  17. 1991 or Q1-1992.
  18.  
  19.  
  20. ------------------------------------------------------------------------
  21.                          --== WARNING!!! ==--
  22.  
  23.  --== THIS VERSION IS NOT A PLUG IN UPGRADE FOR VERSION 2.40!!! ==--
  24.  
  25. ------------------------------------------------------------------------
  26.  
  27.  
  28. Bink 2.50 will MOST DEFINITELY break your 2.40 batch files, if you're
  29. using the "BBS Spawn", "BBS Batch", or "ExtrnMail" methods of calling up
  30. your BBS.
  31.  
  32. The way that Bink hands the baton to the BBS has changed - TWO bps
  33. rates are now passed to the outside world.  Previously, Bink would exit
  34. with the following parameters written to the batch file:
  35.  
  36.  
  37. For the "BBS Batch" and "BBS Spawn" methods,
  38.  
  39. OLD STYLE (v2.40 & earlier):
  40.  
  41. SPAWNBBS %1 %2 %3 %4
  42.  
  43.   %1 = caller's connect rate as reported by the modem
  44.   %2 = the comm port in use
  45.   %3 = time to the next event in minutes
  46.   %4 = extended information in the modem connect string (/ARQ, etc)
  47.  
  48.  
  49. For the "ExtrnMail" method,
  50.  
  51. OLD STYLE (v2.40 & earlier):
  52.  
  53. EXTMAIL %1 %2 %3 %4 %5
  54.  
  55.   %1 = caller's connect rate as reported by the modem
  56.   %2 = the comm port in use
  57.   %3 = time to the next event in minutes
  58.   %4 = errorlevel exit from the original batch file
  59.   %5 = extended information in the modem connect string (/ARQ, etc)
  60.  
  61.  
  62. NOW, BinkleyTerm 2.50 passes the link rate first, and the caller's
  63. actual connect rate as the second parameter.
  64.  
  65.  
  66. For the "BBS Batch" and "BBS Spawn" methods,
  67.  
  68. NEW STYLE (v2.50):
  69.  
  70. SPAWNBBS %1 %2 %3 %4 %5
  71.  
  72.   %1 = speed of the computer-to-modem link rate in bps
  73.   %2 = caller's connect rate reported by the modem
  74.   %3 = the comm port in use
  75.   %4 = time to the next event in minutes
  76.   %5 = extended information in the modem connect string (/ARQ, etc)
  77.  
  78.  
  79. For the "ExtrnMail" method,
  80.  
  81. NEW STYLE (v2.50):
  82.  
  83. EXTMAIL %1 %2 %3 %4 %5 %6
  84.  
  85.   %1 = speed of the computer-to-modem link rate in bps
  86.   %2 = caller's connect rate reported by the modem
  87.   %3 = the comm port in use
  88.   %4 = time to the next event in minutes
  89.   %5 = errorlevel exit from the original batch file
  90.   %6 = extended information in the modem connect string (/ARQ, etc)
  91.  
  92.  
  93. NOTE:  If you're locking your FOSSIL driver, the link rate and connect
  94.        rate passed by BinkleyTerm will be the same (unless the connect
  95.        rate is one of the new HST-reported non-standard rates).  Bink
  96.        has no way of knowing the port's been locked unless it does
  97.        the locking itself via the "Lockbaud" config verb.  Please refer
  98.        to the detailed link/connect rate table later in this document
  99.        for further details.
  100.  
  101.  
  102. For instance, if you previously used this line in your BBS batch file:
  103.  
  104.   Opus Bbs -b%1 -p%2 -t%3
  105.  
  106. Change it to:
  107.  
  108.   Opus Bbs -b%2 -p%3 -t%4
  109.  
  110.  
  111.  
  112. Of course, if you're using the "BBS Exit" method of calling up your BBS,
  113. none of this affects you.  What does affect you is Bink's ability to
  114. recognize the new HST connect strings and how they're handled, explained
  115. later.
  116.  
  117.                                 --- o ---
  118.  
  119.  
  120. Why the change to the batch files?  There's a high-tech feature offered
  121. by USRobotics' Courier HST, HST Dual Standard and Telebit's T2500 modems
  122. that, used in combination with Bink's "LockBaud" config verb, will give
  123. your callers with high-speed error-correcting modems the speed benefits
  124. of a locked port and others will have the responsiveness of a normal
  125. connection.  If you are using one of these modems, the new "LockBaud"
  126. options will allow you to make use of this feature.
  127.  
  128.  
  129. NOTE:  You can continue to use your current floating or locked port setup
  130.        by leaving the "LockBaud" config verb commented out and ignoring
  131.        the following.
  132.  
  133.  
  134. If your HST or HST/DS is the older version with round LEDs, use your
  135. favorite comm program (or Bink's terminal mode), type in "AT&$<RETURN>",
  136. and see if "&B2" is listed as an option.  If it is, you can use
  137. "LockBaud /ARQ".  All v.42bis-capable and newer rectangular LED HST &
  138. HST/DS models support the "&B2" command.
  139.  
  140. If &B2's not listed, try typing in "ATS$<RETURN>", and see if S-Register 27's
  141. bitmap options allow the port to be locked at 19200 and/or 38400 bps.  If so,
  142. use the &B0S27=nnn setup listed below, and you'll be able to lock, but only
  143. at connect speeds of 4800 bps or greater, using "LockBaud 4800".
  144.  
  145. Courier HST and HST Dual Standards manufactured prior to February 1989
  146. (those not supporting the S-register 27 lock options) will not be able to
  147. utilize the new "LockBaud" options.
  148.  
  149.  
  150. Here's how to install this new floating/locked setup:
  151.  
  152.         1) DON'T lock your FOSSIL driver.
  153.  
  154.         2) Enable "LockBaud /ARQ" in Binkley.Cfg (newer HST)
  155.                   "Lockbaud 4800" in Binkley.Cfg (older HST)
  156.                                -or-
  157.                   "LockBaud /REL" in Binkley.Cfg (T2500)
  158.  
  159.         3) Store "&A1", "&A2" or "&A3" in non-volatile RAM to
  160.            enable the /ARQ extended result strings (HST)
  161.  
  162.         4) Store "&B2" in non-volatile RAM (newer HST)
  163.            Store "&B0S27=128" for 19200 locking (older HST)
  164.            Store "&B0S27=192" for 38400 locking (older HST)
  165.                                -or-
  166.            Store "S66=2" in non-volatile RAM (T2500)
  167.  
  168.         5) If your BBS software allows you to pass the port rate separately
  169.            (as with Maximus v1.02), call up the BBS as follows:
  170.  
  171.             Max Bbs -b%2 -p%3 -t%4 -s%1
  172.  
  173.             (where %1 is the port rate and %2 is the connect rate)
  174.  
  175.         6) If your BBS doesn't allow passing the link (port) speed
  176.            separately from the connect speed (as with Opus), you can use
  177.            the following kludge in your SPAWNBBS or EXTMAIL batch file
  178.            (using X00's XU.EXE or the similar utility included with your
  179.            FOSSIL driver):
  180.  
  181.                 Rem convert 1-based port from Bink to 0-based for XU
  182.                 If "%3" == "1" SET PORT=0
  183.                 If "%3" == "2" SET PORT=1
  184.                 .
  185.                 .
  186.  
  187.                 Rem it's always OK to lock with XU since unlock follows
  188.                 XU LOCK:%PORT%:%1
  189.                 Opus Bbs -b%2 -p%3 -t%4
  190.                 if ERRORLEVEL . .
  191.                 .
  192.                 .
  193.                 Rem unlock the port
  194.                 XU LOCK:%PORT%:OFF
  195.  
  196.            Note that Opus uses a 1-based comm port number, but XU & X00
  197.            use a 0-based comm port number.
  198.  
  199.  
  200. In the docs for Opus 1.72a, this alternative method has been described:
  201. NOTE:  This behavior has NOT been verified!
  202.  
  203. ------------------------------------------------------------------------
  204.       New command-line parameter: -a[modem string]
  205.  
  206.       This ONLY affects  people who are  using Binkley 2.5+ and  HST/DS
  207.       modems and the Dual Standard's &B2 option!
  208.  
  209.       Binkley 2.50  will  be sending  the modem  connect string  infor-
  210.       mation,  the stuff after the  baud rate, out  as a separate para-
  211.       meter. I don't remember  exactly the sequence, but for  Opus 1.72
  212.       there are two ways to handle it:
  213.  
  214.          (Example! I don't know exactly how Binkley is handling this!)
  215.  
  216.          %1  User Baud
  217.          %2  Port
  218.          %3  Time to next event
  219.          %4  Locked Baud
  220.          %5  Extended modem information.
  221.  
  222.       From a batch file you would call Opus as:
  223.  
  224.         Opus bbs -b%1 -p%2 -t%3 -a%5
  225.  
  226.       However, Opus will ALSO accept this:
  227.  
  228.         Opus bbs -b%1%5 -p%2 -t%3
  229.  
  230.       Either way  Opus will see the /ARQ and  know that if &B2 has been
  231.       configured that  the baud  rate  is locked,  if the  /ARQ is  not
  232.       there, the baud rate will float.
  233. ---------------------